home *** CD-ROM | disk | FTP | other *** search
/ Computer Select (Limited Edition) / Computer Select.iso / msj / v06n06 / intnat.exe / INTERN.EXE / INTERNAT.DOC < prev    next >
Encoding:
Text File  |  1991-11-01  |  8.0 KB  |  190 lines
  1.                 INTERNAT
  2.  
  3.                Version 1.3
  4.  
  5.              William S. Hall
  6.              3665 Benton Street, #66
  7.               Santa Clara, CA 95051
  8.  
  9.  
  10.               Introduction
  11.  
  12.      INTERNAT is a Microsoft Windows application which can be
  13. used to demonstrate a number of features of Windows related to
  14. writing international applications.  To use INTERNAT effectively,
  15. you should be familiar with the Windows Software Development Kit.
  16.  
  17.      INTERNAT starts up with a request to select a language.  In
  18. this version, you can take the default (English) or switch to Pig
  19. Latin (see below for the necessary files).
  20.  
  21.      The INTERNAT window normally displays the Windows character
  22. set on the left side if no command has been toggled.  The full
  23. range from 0 to 255 in ascending order is shown with 16
  24. characters on each line.  If a command has been toggled on, the
  25. display takes on different characteristics as described below. 
  26. In some cases, the OEM character set may be displayed instead of
  27. Windows ANSI.
  28.  
  29.      If you strike a key on the keyboard, the message parameters
  30. for WM_KEYDOWN, WM_KEYUP, and WM_CHAR or WM_DEADCHAR are
  31. displayed on the right side of the Window.  These include, in
  32. order, the repeat count, OEM scan code, and the flags (the high
  33. word of lParam).
  34.  
  35.      INTERNAT has six basic commands:  Windows functions, C
  36. functions, OEM functions, Information, Language, and Help.  In
  37. this version, Help only serves to display the ubiquitous 'About'
  38. box.  Below we describe the effect of the remaining menus.
  39.  
  40.      As many of the commands change the display, a good way to
  41. compare the results is to run INTERNAT twice, minimize other
  42. applications, tile your desktop until the two instances are
  43. side-by-side, and execute the commands on only one of the
  44. programs.
  45.  
  46.      INTERNAT does not always follow good enabling techniques in
  47. string handling.  As the program develops, this will hopefully
  48. improve.
  49.  
  50.  
  51.            The Windows Functions Menu
  52.  
  53.      The behavior of the commands in this group depends on the
  54. installed language module.  Each command uses the Windows
  55. function call having the same name (or its 'Buff' equivalent).
  56.  
  57.      AnsiUpper converts each character in the Windows character
  58. set to upper case and displays the result in ascending order.
  59.  
  60.      AnsiLower converts each character in the Windows character
  61. set to lower case and displays the result in ascending order.
  62.  
  63.      IsCharAlpha displays each alphabetic character in the
  64. Windows character set in order from 0-255.  An underscore is
  65. shown for each non-alphabetic character.
  66.  
  67.      IsCharAlphaNumeric displays each alphabetic or numeric
  68. character in the Windows character set in order from 0-255.  An
  69. underscore is shown for non-alphanumeric characters.
  70.  
  71.      IsCharUpper displays each alphabetic character in the
  72. Windows character set in order from 0-255 if it is an upper case
  73. form.  Otherwise an underscore is shown.
  74.  
  75.      IsCharLower displays each alphabetic character in the
  76. Windows character set in order from 0-255 if it is a lower case
  77. form.  Otherwise an underscore is shown.
  78.  
  79.      lstrcmp sort performs a case-dependent quicksort on the
  80. Windows character set using the Windows lstrcmp function and
  81. displays the result in ascending order.
  82.  
  83.      lstrcmpi sort performs a case-independent quicksort on the
  84. Windows character set using the Windows lstrcmpi function and
  85. displays the result in ascending order.
  86.  
  87.      lstrcmp test allows you to enter two strings and see the
  88. effects of both case-dependent and case-independent comparisons.
  89. You can also observe how various language modules handle special
  90. cases such as 'ss' (ANSI code point 223), 'ae' (ANSI code point
  91. 230), and other combinations such as 'ch', 'll', 'ij', etc.
  92.  
  93.      List sort presents you with a dialog box containing a file
  94. name edit field and two list boxes.  Type in the name of a text
  95. file and select Open.  Each line of the file will be entered into
  96. each list; the one on the left will be sorted according to the
  97. current language module.  The one on the right will be unsorted.
  98. For best results, use lines of one word each.  No horizontal
  99. scrolling is provided at this time.
  100.      There are five benchmark sample files you can try.  These
  101. files provide culturally correct sorted word lists in several
  102. languages as well as one special list of mostly scientific
  103. expressions.  Be sure to install the corresponding language
  104. modules.  You will find that Windows does a fair but not perfect
  105. job of sorting the lists.
  106.  
  107.  
  108.               The C Functions Menu
  109.  
  110.      These commands use the ordinary C-library functions to
  111. perform the same tasks as the Windows Functions Menu items.  They
  112. are supplied to illustrate the inadequacy of these functions for
  113. the Windows character set since they operate only on characters
  114. in the ASCII range.  Each function parallels the corresponding
  115. Windows one and requires no detailed explanation.
  116.  
  117.  
  118.               OEM Functions
  119.  
  120.      These commands illustrate some of the resources available in
  121. Windows to cope with character set conversions between the
  122. Windows character set and the underlying MSDOS code page (OEM
  123. character set).
  124.  
  125.      ANSItoOEM converts each element in a 256 byte buffer
  126. containing values from 0-255 in ascending order to the
  127. corresponding ANSI character and displays the result in the OEM
  128. character set.  Because the two character sets do not map onto
  129. each other, you will see the effects of character folding in the
  130. resulting display.
  131.  
  132.      OEMtoANSI converts each element in a 256 byte buffer
  133. containing values from 0-255 in ascending order to the
  134. corresponding OEM character and displays the result in the
  135. Windows character set.  Because the two character sets do not map
  136. onto each other, you will see the effects of character folding in
  137. the resulting display.
  138.  
  139.      OEM Convert shows the effect of the edit box style
  140. ES_OEMCONVERT (and the corresponding style CBS_OEMCONVERT for
  141. combo boxes).  By typing characters in the edit box, you can see
  142. how they are converted to the nearest available OEM character in
  143. the Windows character set and displayed to the user.  The
  144. OEMCONVERT style is usually used in dialogs which manipulate DOS
  145. files.  You can toggle the style on and off with the checkbox.
  146.  
  147.      OEM Character Set displays the OEM font currently in use
  148. by Windows in ascending order from 0-255.
  149.  
  150.  
  151.               The Information Menu
  152.  
  153.      The commands in this group display miscellaneous information
  154. available through the Windows API and by reading WIN.INI,
  155. SYSTEM.INI, and SETUP.INF.
  156.  
  157.      Keyboard Codepage simply shows the code page that Windows
  158. detected when you initially installed Windows.  It does not
  159. reflect the current code page.  Hence this information may not be
  160. very useful if you are using code page switching from MSDOS.  You
  161. can actually reset your current code page by running Windows
  162. Setup in the Windows directory from MSDOS and selecting both a
  163. display and keyboard type.  Make the selection, even if you have
  164. not changed your hardware so that Setup thinks you have actually
  165. changed something.  If you have changed your code page, you will
  166. be prompted for a diskette containing the needed OEM font.
  167.  
  168.      Keyboard Type reads the type, subtype, and number of
  169. function keys.  Type 1 is an XT keyboard, type 3 is an AT
  170. keyboard, and type 4 is an extended 101/102 keyboard.  See your
  171. Windows manual for explanations of other types.
  172.  
  173.      Keyboard Layout reads SYSTEM.INI to get the installed
  174. keyboard table, then looks up the name in SETUP.INF.
  175.  
  176.      International Items reads the current strings and values
  177. from the [intl] section in win.ini and displays them.  You will
  178. need to consult other sources for a complete interpretation of
  179. each field.  You can also use the International option in the
  180. Control Panel to observe the effects of changing the various
  181. parameters.
  182.  
  183.      The Language command allows you to switch into Pig Latin to
  184. see the effects of language localization.  You must have the file
  185. INTERPGL.DLL somewhere in your path or the switch will not take
  186. place.
  187.  
  188.      Source code for INTERNAT will be provided on request if you
  189. cannot get it from a bulletin board or online service.
  190.